<!DOCTYPE html>
<!-- Generated by pkgdown: do not edit by hand --><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><title>Check if lat lon are OK – validate latitudes and longitudes — latlon_is.valid • EJAM</title><!-- favicons --><link rel="icon" type="image/png" sizes="16x16" href="../favicon-16x16.png"><link rel="icon" type="image/png" sizes="32x32" href="../favicon-32x32.png"><link rel="apple-touch-icon" type="image/png" sizes="180x180" href="../apple-touch-icon.png"><link rel="apple-touch-icon" type="image/png" sizes="120x120" href="../apple-touch-icon-120x120.png"><link rel="apple-touch-icon" type="image/png" sizes="76x76" href="../apple-touch-icon-76x76.png"><link rel="apple-touch-icon" type="image/png" sizes="60x60" href="../apple-touch-icon-60x60.png"><script src="../deps/jquery-3.6.0/jquery-3.6.0.min.js"></script><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><link href="../deps/bootstrap-5.3.1/bootstrap.min.css" rel="stylesheet"><script src="../deps/bootstrap-5.3.1/bootstrap.bundle.min.js"></script><link href="../deps/font-awesome-6.4.2/css/all.min.css" rel="stylesheet"><link href="../deps/font-awesome-6.4.2/css/v4-shims.min.css" rel="stylesheet"><script src="../deps/headroom-0.11.0/headroom.min.js"></script><script src="../deps/headroom-0.11.0/jQuery.headroom.min.js"></script><script src="../deps/bootstrap-toc-1.0.1/bootstrap-toc.min.js"></script><script src="../deps/clipboard.js-2.0.11/clipboard.min.js"></script><script src="../deps/search-1.0.0/autocomplete.jquery.min.js"></script><script src="../deps/search-1.0.0/fuse.min.js"></script><script src="../deps/search-1.0.0/mark.min.js"></script><!-- pkgdown --><script src="../pkgdown.js"></script><meta property="og:title" content="Check if lat lon are OK – validate latitudes and longitudes — latlon_is.valid"><meta name="description" content="Check each latitude and longitude value to see if they are valid."><meta property="og:description" content="Check each latitude and longitude value to see if they are valid."><meta property="og:image" content="https://usepa.github.io/EJAM/logo.svg"></head><body>
    <a href="#main" class="visually-hidden-focusable">Skip to contents</a>


    <nav class="navbar navbar-expand-lg fixed-top bg-light" data-bs-theme="light" aria-label="Site navigation"><div class="container">

    <a class="navbar-brand me-2" href="../index.html">EJAM</a>

    <small class="nav-text text-warning me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">2.32.0</small>


    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>

    <div id="navbar" class="collapse navbar-collapse ms-3">
      <ul class="navbar-nav me-auto"><li class="active nav-item"><a class="nav-link" href="../reference/index.html">Reference</a></li>
<li class="nav-item dropdown">
  <button class="nav-link dropdown-toggle" type="button" id="dropdown-articles" data-bs-toggle="dropdown" aria-expanded="false" aria-haspopup="true">Articles</button>
  <ul class="dropdown-menu" aria-labelledby="dropdown-articles"><li><hr class="dropdown-divider"></li>
    <li><h6 class="dropdown-header" data-toc-skip>Overview for EJAM Users</h6></li>
    <li><a class="dropdown-item" href="../articles/0_whatis.html">What is EJAM</a></li>
    <li><a class="dropdown-item" href="../articles/0_webapp.html">Using EJAM</a></li>
    <li><hr class="dropdown-divider"></li>
    <li><h6 class="dropdown-header" data-toc-skip>For analysts using R</h6></li>
    <li><a class="dropdown-item" href="../articles/1_installing.html">Installing the EJAM R package</a></li>
    <li><a class="dropdown-item" href="../articles/2_quickstart.html">Quick Start Guide</a></li>
    <li><a class="dropdown-item" href="../articles/3_analyzing.html">Basics of Using EJAM for Analysis in RStudio</a></li>
    <li><a class="dropdown-item" href="../articles/4_advanced.html">Advanced Features</a></li>
  </ul></li>
<li class="nav-item"><a class="nav-link" href="../news/index.html">Changelog</a></li>
      </ul><ul class="navbar-nav"><li class="nav-item"><form class="form-inline" role="search">
 <input class="form-control" type="search" name="search-input" id="search-input" autocomplete="off" aria-label="Search site" placeholder="Search for" data-search-index="../search.json"></form></li>
<li class="nav-item"><a class="external-link nav-link" href="https://github.com/USEPA/EJAM/" aria-label="GitHub"><span class="fa fab fa-github fa-lg"></span></a></li>
      </ul></div>


  </div>
</nav><div class="container template-reference-topic">
<div class="row">
  <main id="main" class="col-md-9"><div class="page-header">
      <img src="../logo.svg" class="logo" alt=""><h1>Check if lat lon are OK – validate latitudes and longitudes</h1>
      <small class="dont-index">Source: <a href="https://github.com/USEPA/EJAM/blob/HEAD/R/latlon_is.valid.R" class="external-link"><code>R/latlon_is.valid.R</code></a></small>
      <div class="d-none name"><code>latlon_is.valid.Rd</code></div>
    </div>

    <div class="ref-description section level2">
    <p>Check each latitude and longitude value to see if they are valid.</p>
    </div>

    <div class="section level2">
    <h2 id="ref-usage">Usage<a class="anchor" aria-label="anchor" href="#ref-usage"></a></h2>
    <div class="sourceCode"><pre class="sourceCode r"><code><span><span class="fu">latlon_is.valid</span><span class="op">(</span></span>
<span>  <span class="va">lat</span>,</span>
<span>  <span class="va">lon</span>,</span>
<span>  quiet <span class="op">=</span> <span class="cn">TRUE</span>,</span>
<span>  invalid_msg_table <span class="op">=</span> <span class="cn">FALSE</span>,</span>
<span>  exact_but_slow_islandareas <span class="op">=</span> <span class="cn">FALSE</span></span>
<span><span class="op">)</span></span></code></pre></div>
    </div>

    <div class="section level2">
    <h2 id="arguments">Arguments<a class="anchor" aria-label="anchor" href="#arguments"></a></h2>


<dl><dt id="arg-lat">lat<a class="anchor" aria-label="anchor" href="#arg-lat"></a></dt>
<dd><p>vector of latitudes
(or data.frame with colnames lat and lon, in which case lon param must be missing)</p></dd>


<dt id="arg-lon">lon<a class="anchor" aria-label="anchor" href="#arg-lon"></a></dt>
<dd><p>vector of longitudes</p></dd>


<dt id="arg-quiet">quiet<a class="anchor" aria-label="anchor" href="#arg-quiet"></a></dt>
<dd><p>optional logical, if TRUE, show list of bad values in console</p></dd>


<dt id="arg-invalid-msg-table">invalid_msg_table<a class="anchor" aria-label="anchor" href="#arg-invalid-msg-table"></a></dt>
<dd><p>set TRUE if you want a data.frame with colnames "valid" and "invalid_msg"</p></dd>


<dt id="arg-exact-but-slow-islandareas">exact_but_slow_islandareas<a class="anchor" aria-label="anchor" href="#arg-exact-but-slow-islandareas"></a></dt>
<dd><p>see <code><a href="latlon_is.islandareas.html">latlon_is.islandareas()</a></code></p></dd>

</dl></div>
    <div class="section level2">
    <h2 id="value">Value<a class="anchor" aria-label="anchor" href="#value"></a></h2>
    <p>logical vector, one element per lat lon pair (location)</p>
    </div>
    <div class="section level2">
    <h2 id="details">Details<a class="anchor" aria-label="anchor" href="#details"></a></h2>
    <p>NA or outside expected numeric ranges</p>
<p>(based on approx ranges of lat lon seen among block internal points dataset)</p>
<p>But note Guam, American Samoa, Northern Mariana Islands, and U.S. Virgin Islands ranges are approximated!
EJScreen has not had demographic data in those locations anyway, but can map sites there.
see latlon_is.islandareas()
and note details at https://www.britannica.com/place/Trust-Territory-of-the-Pacific-Islands
on areas no longer part of the US but still with some sites in FRS,
ids "110009291462" "110013804678" "110067353429" "110067377430" "110070929074"
e.g., https://echo.epa.gov/detailed-facility-report?fid=110067353429
or https://echo.epa.gov/detailed-facility-report?fid=110013804678</p>
<p>lat must be between 17.5 and 71.5, and</p>
<p>lon must be ( between -180 and -64) OR (between 172 and 180)</p>
    </div>
    <div class="section level2">
    <h2 id="see-also">See also<a class="anchor" aria-label="anchor" href="#see-also"></a></h2>
    <div class="dont-index"><p><code><a href="latlon_is.usa.html">latlon_is.usa()</a></code> <code><a href="latlon_is.islandareas.html">latlon_is.islandareas()</a></code> <code><a href="latlon_is.available.html">latlon_is.available()</a></code> <code><a href="latlon_is.possible.html">latlon_is.possible()</a></code>
<code><a href="latlon_df_clean.html">latlon_df_clean()</a></code> <code><a href="latlon_infer.html">latlon_infer()</a></code> <code>latlon_is.valid()</code> <code><a href="latlon_as.numeric.html">latlon_as.numeric()</a></code></p></div>
    </div>

    <div class="section level2">
    <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-examples"></a></h2>
    <div class="sourceCode"><pre class="sourceCode r"><code><span> <span class="kw">if</span> <span class="op">(</span><span class="cn">FALSE</span><span class="op">)</span> <span class="op">{</span> <span class="co"># \dontrun{</span></span>
<span> <span class="co"># this would only work using the EJAM package datasets frs and blockpoints:</span></span>
<span>   <span class="kw">if</span> <span class="op">(</span><span class="op">!</span><span class="fu"><a href="https://rdrr.io/r/base/exists.html" class="external-link">exists</a></span><span class="op">(</span><span class="st">"frs"</span><span class="op">)</span><span class="op">)</span> <span class="fu"><a href="dataload_from_pins.html">dataload_from_pins</a></span><span class="op">(</span><span class="st">"frs"</span><span class="op">)</span></span>
<span> <span class="fu"><a href="https://rdrr.io/r/base/table.html" class="external-link">table</a></span><span class="op">(</span><span class="fu">latlon_is.valid</span><span class="op">(</span>lat <span class="op">=</span>  <span class="va">frs</span><span class="op">$</span><span class="va">lat</span>, lon <span class="op">=</span>  <span class="va">frs</span><span class="op">$</span><span class="va">lon</span><span class="op">)</span><span class="op">)</span></span>
<span> <span class="co"># blockpoints may need to be downloaded using dataload_from_pins()</span></span>
<span> <span class="fu"><a href="https://rdrr.io/r/base/table.html" class="external-link">table</a></span><span class="op">(</span><span class="fu">latlon_is.valid</span><span class="op">(</span>lat <span class="op">=</span>  <span class="va">blockpoints</span><span class="op">$</span><span class="va">lat</span>, lon <span class="op">=</span>  <span class="va">blockpoints</span><span class="op">$</span><span class="va">lon</span><span class="op">)</span><span class="op">)</span></span>
<span>  <span class="op">}</span> <span class="co"># }</span></span>
<span></span></code></pre></div>
    </div>
  </main><aside class="col-md-3"><nav id="toc" aria-label="Table of contents"><h2>On this page</h2>
    </nav></aside></div>


    <footer><div class="pkgdown-footer-left">
  <p>US EPA 2024</p>
</div>

<div class="pkgdown-footer-right">
  <p>EJAM Version 2.32.0</p>
</div>

    </footer></div>





  </body></html>

